home *** CD-ROM | disk | FTP | other *** search
/ Meeting Pearls 4 / Meeting Pearls Vol. IV (1996)(GTI - Schatztruhe)[!].iso / Pearls / texmf / doc / latex / base / yandytex.txt < prev   
Text File  |  1996-06-19  |  8KB  |  182 lines
  1.  
  2.                 LaTeX installation instructions for Y&Y TeX
  3.  
  4.                              1996 January 1
  5.  
  6. SUMMARY 
  7. ======= 
  8.  
  9. This file contains instructions for installing LaTeX 2e for Y&Y TeX.
  10. It describes: 
  11.  
  12.  * How to install LaTeX 2e from the diskette that comes with Y&Y TeX.
  13.  
  14.  * How to unpack a new LaTeX distribution obtained from CTAN.
  15.  
  16.  * How to check the LaTeX installation. 
  17.  
  18.  * What to do if you have any problems.
  19.  
  20. INITIAL INSTALLATION OF LaTaX 2e:
  21. =================================
  22.  
  23. The Y&Y TeX System comes with a LaTeX 2e diskette that includes an
  24. installation batch file.  Included is the LaTeX 2e `format' file as 
  25. well as the class files.  Just type  
  26.  
  27.     a:install (or b:install) 
  28.  
  29. with the LaTeX 2e diskette in the diskette drive after installing Y&Y TeX
  30. itself.  This will put the files in the standard places.  Type a:install -?
  31. to see how you can control where the files are installed.
  32.  
  33. The Y&Y TeX System also includes a second diskette with LaTeX 2e packages,
  34. which you can install in toto using the batch file on that diskette.
  35. Alternatively, just unzip the files for individual packages as needed.
  36.  
  37. REFRESHING YOUR INSTALLATION OF LaTeX 2e:
  38. ========================================
  39.  
  40. If you do at some later time want to refresh your LaTeX 2e installation
  41. using the latest files from CTAN, do the following:
  42.  
  43. Find the directory on your machine with the LaTeX 2e files --- in the
  44. standard installation this would be c:\yandytex\latex2e.  
  45.  
  46. (i)   Make this `LaTeX 2e directory' the current directory.  
  47.  
  48. (ii)  FTP the files in directory tex-archive/macros/latex2e/base on CTAN 
  49.       and put them into your `LaTeX 2e directory' (overwriting older 
  50.       versions of the files in the process).
  51.  
  52. (iii) Run TeX on `unpack.ins.'  That is, type `tex unpack.ins.'
  53.       This will create around 230 files (in perhaps five minutes or so).
  54.  
  55. (iv)  Now run ini-TeX on `latex.ltx.'  That is, type `tex -i latex.ltx'.
  56.  
  57. (v)   Finally, move the new `latex.fmt' file to the TEXFORMATS directory ---
  58.       in the standard installation this would be c:\yandytex\fmt.
  59.  
  60. *     You now have an up-to-date LaTeX 2e installation!  
  61.  
  62. You can, if you prefer, call TeX on `unpack.ins' and ini-TeX on `latex.ltx'
  63. directly from the `TeX Menu' in DVIWindo.  But then:
  64.  
  65. (i)  If you use a common working directory for your DVI files, first disable
  66.      this by removing the check mark on the `Working Directory' menu item.
  67.      This is to make sure files written by TeX and ini-TeX go right back into
  68.      the `LaTeX 2e' directory, rather than into the common working directory.
  69.  
  70. (ii) You may need to temporarily change the TEXINPUTS environment variable 
  71.      (in the [Environment] section of `dviwindo.ini' in the Windows directory)
  72.      so that it lists the directory with your LaTeX 2e files first.  Otherwise
  73.      you run the risk of getting complaints about old versions of files like
  74.      `docstrip.tex' being picked up from other directories.
  75.  
  76. Note: if you have an old installation this may not work correctly because 
  77. the ini-TeX call has some LaTeX 2e names hard-wired in, and these names have
  78. changed.  In this case call ini-TeX directly from the DOS prompt as above.
  79.  
  80. SOME OTHER HANDY TIPS:
  81. ======================
  82.  
  83. Creation of the LaTeX 2e format by ini-TeX requires a hyphenation file.  For
  84. English, use the file `hyphen.tex' supplied with the system (in the `LaTeX'
  85. directory, which is typically c:\yandytex\latex).  If ini-TeX complains that
  86. it can't find `hyphen.tex,' either make sure that it is in one of the
  87. directories listed in TEXINPUTS, or copy it to the `LaTeX 2e' directory. 
  88. (By the way, for multilingual use consider the `babel' package).
  89.  
  90. It us useful to create `format specific' TEXINPUTS environment variables.
  91. This is handy when you regularly used several different TeX `formats'
  92. (for example, when you need to run both LaTeX 2.09 and LaTeX 2e for some
  93. reason).  Use variables named PLAIN, LPLAIN, and LATEX for plain TeX, LaTeX
  94. 2.09, and LaTeX 2e respectively  (These go into the [Environment] section 
  95. of the `dviwindo.ini' file in your Windows directory).
  96.  
  97. Note that in the semicolon-separated list specified for TEXINPUTS (or format
  98. specific variable as described above), you can add \ or \\ to the end of a
  99. directory name in order to get one level or recursive directory searching
  100. respectively.  This can be convenient if you have many TeX source files in a
  101. hierarchical directory structure, as for example, the LaTeX 2e packages.
  102.  
  103. ADDING LaTeX 2e TO AN OLDER INSTALLATION:
  104. =========================================
  105.  
  106. Proceed as above, but make sure to add the `LaTeX 2e' directory to the
  107. list of directores in the TEXINPUTS environment variable.  For example,
  108.  
  109.         TEXINPUTS=c:\yandytex\latex2e;c:\packages\psnfss;c:\texinput
  110.  
  111. or create an environment variable called LATEX for this purpose (see above).
  112.  
  113. Also, create a new `TeX Menu' entry for LaTeX 2e by holding down the
  114. `Control' key and selecting `LaTeX 2.09' from the `TeX Menu.'  Edit the
  115. `Menu Item Name' field to read `LaTeX 2e|F7' (or whatever `hot key'
  116. you want to use), and edit the `Application Call Pattern' to read 
  117.  
  118.         tex &latex @.tex
  119.  
  120. (in Windows NT, use + or ^& instead of &).  Then click `Add.'
  121.  
  122. CHECKING THAT THE INSTALLATION WORKED 
  123. ===================================== 
  124.  
  125. To check that the installation worked, run the new LaTeX 2e on the file
  126. `ltxcheck.tex'.  You can do this from DVIWindo's `TeX Menu.'  Simply select
  127. `LaTeX 2e,' and navigate to `c:\yandytex\latex2e\ltxcheck.tex' (or wherever
  128. you placed your LaTeX 2e source files) in the `Open File' dialog.
  129.  
  130. It is highly recommended that you run this test before going on!
  131. The test file will check some basic features of your TeX setup and 
  132. either say they are OK or complain and say they are BAD.
  133.  
  134. After this, you may also wish to process `usrguide.tex' and print the
  135. result, unless you have already done so (and perhaps `fntguide.tex').
  136. Also note that LaTeX 2e `packages' each come with their own documentation 
  137. (which is likely to be more up to date than `The LaTeX Companion').
  138.  
  139. PROBLEMS 
  140. ======== 
  141.  
  142. If you have a very old Y&Y TeX System, then it may be set up for the LaTeX 2e
  143. beta test file names.  In this case run ini-TeX from the DOS command line.
  144.  
  145. If you have other problems with the LaTeX installation, see the `PROBLEMS'
  146. section in `install.txt'. 
  147.  
  148. If `ltxcheck' produces a `BAD' message, you will typically be able to
  149. figure out from the message what is wrong.  For example, you may not
  150. have the environment variable TEXINPUTS set up to include the new
  151. LaTeX 2e files.  If it is not obvious what caused the `BAD' message,
  152. then please consult the section on `ltxcheck' in `texpert.txt'. 
  153.  
  154. WARNING:   When using fonts other than Computer Modern, look out for 
  155.            font naming problems.  For example, with LucidaBright +
  156.            LucidaNewMath, \usepackage{lucidbry} will use the actual font
  157.            names, while \usepackage{lucidbrb} will use Karl Berry names.
  158.  
  159. WARNING:   When using fonts other than Computer Modern, look out for font
  160.            encoding (character layout) problems.  LaTeX 2e directly supports
  161.            the old `TeX text' encoding (OT1 -- textext.vec), and the new
  162.            `Cork' encoding (T1 -- tex256.vec).  Use `\input texnansi' for 
  163.            TeX 'n ANSI encoding, or `\input ansiacce' for Windows ANSI etc.
  164.  
  165. Like LaTeX 2e itself, auxiliary files supplied by Y&Y are at times revised
  166. and improved.  Check out the `What's New' section on http://www.YandY.com.
  167.  
  168. If you have any problems not resolved by the above, please contact Y&Y at:
  169.  
  170. tech-help@YandY.com             (email)
  171. (508) 371-2004                  (fax)
  172. (508) 371-3286                  (voice)
  173.  
  174. Y&Y, Inc.
  175. 45 Walden Street                (snail mail)
  176. Concord, MA, 01742, USA
  177.  
  178. --- Copyright 1994, 1995, 1996 (C) Y&Y, Inc. and the LaTeX3 project --- 
  179. ---              All rights reserved.                --- 
  180.  
  181.  
  182.